home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / graphics / ctoc41.arj / CTC.DOC < prev    next >
Text File  |  1993-10-01  |  41KB  |  842 lines

  1.  
  2.                              C O D E  T O  C O D E
  3.                              _____________________
  4.                             (C) Copyright 1989, 1990
  5.  
  6.                             ALPHABTYES, INCORPORATED
  7.                              111 Eighth Street, S.E.
  8.                              Washington, D.C. 20003
  9.                                 (202)  546-4119
  10.                                   Bruce Robey
  11.                              CompuServe: 71131,2734
  12.                                   Version 4.1
  13.  
  14.  
  15.               ┌─────────┐                      This program is produced by a
  16.         ┌─────┴───┐     │              (R)     member of the Association of
  17.       ──│         │o    │──────────────────    Shareware Professionals (ASP).
  18.         │   ┌─────┴╨──┐ │  Association of      ASP wants to make sure that
  19.         │   │         │─┘  Shareware           the shareware principle works
  20.         └───│    o    │    Professionals       for you.  If you are unable to
  21.       ──────│    ║    │────────────────────    resolve a shareware-related
  22.             └────╨────┘    MEMBER              problem with an ASP member by
  23.                                                contacting the member directly,
  24.    ASP may be able to help. The ASP Ombudsman can help you resolve a dispute
  25.    or problem with an ASP member, but does not provide technical support for
  26.    members' products.  Please write to the ASP Ombudsman at P.O. Box 5786,
  27.    Bellevue, WA 98006 or send a Compuserve message via CompuServe Mail to ASP
  28.    Ombudsman 70007,3536
  29.  
  30.  
  31.    Shareware Concept
  32.    _________________
  33.  
  34.    CODE TO CODE is Shareware, not in the Public Domain. You are granted,
  35.    at no charge, the right to determine the suitability of this software
  36.    for your needs. If you do find CODE TO CODE suitable and make use of
  37.    it, you are expected to register with the author.  Registration will
  38.    remove the delay screen, grant unlimited telephone support privileges
  39.    and provide printed documentation with ample screen examples.  Your
  40.    contribution helps Shareware authors bring better and more affordable
  41.    software to you.  Please redistribute this program to others.
  42.  
  43.                           Registration $29.00
  44.                       Visa and MasterCard honored
  45.  
  46.  
  47.                          DISCLAIMER OF WARRANTY
  48.                          ______________________
  49.  
  50.     DUE TO THE LARGE NUMBER OF HARDWARE AND SOFTWARE ENVIRONMENTS INTO
  51.     WHICH THIS PROGRAM MAY BE PLACED, NO WARRANTY OF FITNESS FOR A
  52.     PARTICULAR PURPOSE IS OFFERED.  THOROUGHLY TEST THIS PROGRAM WITH
  53.     NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER MUST ASSUME THE
  54.     ENTIRE RISK OF USING THIS PROGRAM.  THE SELLER'S MAXIMUM LIABILITY
  55.     WILL BE LIMITED TO REFUND OF THE PURCHASE PRICE OR PROGRAM
  56.     REPLACEMENT.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                               TABLE OF CONTENTS
  63.                               _________________
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    Purpose......................................................1
  71.    How It Works.................................................1
  72.    What It Can't Do.............................................2
  73.    Installation
  74.        Hard Disk................................................3
  75.        Floppy Disk..............................................3
  76.    Operation
  77.    Decode.......................................................3
  78.        Ventura Publisher........................................4
  79.        XyWrite..................................................5
  80.        Penta....................................................5
  81.        Magna....................................................6
  82.    Recode.......................................................6
  83.    Split........................................................7
  84.    Join.........................................................7
  85.    Make.........................................................8
  86.    Change.......................................................9
  87.    Quads........................................................9
  88.    Main Screen Options..........................................9
  89.    Command Line Options.........................................11
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97. NOTE: if you are updating from a previous version of CODE TO CODE skip to
  98.       page 8.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.   ALPHABYTES, INCORPORATED is a member of:
  105.     The Association of Shareware Professionals
  106.     Printing Industry of America
  107.     Printing Industry of Metropolitan Washington
  108.     National Composition and Prepress Association
  109.  
  110.  
  111.    Code to Code is a trademark of AlphaBytes, Incorporated
  112.    Ventura Publisher is a trademark of Ventura Software, Inc.
  113.    XyWrite is a trademark of XyQuest, Inc.
  114.    Penta is a trademark of Penta Systems International.
  115.    MagnaType is a trademark of Magna Computer Systems.
  116.  
  117.                                       Page 1
  118.  
  119.    Purpose
  120.    _______
  121.  
  122.    CODE TO CODE is a collection of programs, written in Microsoft "C",
  123.    designed to move, delete or translate codes from various DTP, word
  124.    processor, and typesetter files.  CODE TO CODE can:
  125.  
  126.                 ■ Move codes from an encoded file to a separate uncoded
  127.                   file.  The "uncoded" file can be edited without
  128.                   cumbersome and cryptic codes in the way.  After edit-
  129.                   ing, the codes can be restored to the "decoded" file,
  130.                   creating a new complete file.
  131.  
  132.                 ■ Permanently remove (strip) the codes from the file.
  133.  
  134.                 ■ Quickly build translation tables automatically.
  135.  
  136.                 ■ Translate codes between most typesetting, word processing
  137.                   and desktop publishing systems.
  138.  
  139.                 ■ Split large files into smaller files, with user
  140.                   controlled break points.  The split files may be edited
  141.                   and then rejoined into one big file.
  142.  
  143.    Applications
  144.    ____________
  145.  
  146.                 ■ Automatically create on-line service documents using DTP or
  147.                   typesetter files.
  148.  
  149.                 ■ Allow editors --intimidated by cryptic codes-- to easily
  150.                   edit code-free documents and then automatically have the
  151.                   codes reinserted.
  152.  
  153.                 ■ Spell-check or run a thesaurus on a "decoded" file.  With
  154.                   the codes removed spell-checkers will not flag the codes as
  155.                   misspelled words.
  156.  
  157.                 
  158.  
  159.    How It Works
  160.    ____________
  161.  
  162.    CODE TO CODE reads the ASCII file designated as the Encoded file,
  163.    searching for codes.  Codes are defined as characters that occur between
  164.    two delimiters. The program asks for the delimiters for the type of file
  165.    to be converted.
  166.                                       Examples:
  167.  
  168.                       Program        Delimiters     Precedence
  169.  
  170.                 Ventura Publisher       < >            @
  171.                 XyWrite dec. 174,175    « »           none
  172.                 Penta                   [ ]            ;
  173.  
  174.                                       Page 2
  175.  
  176.                 Magna                   < >            $
  177.  
  178.    When CODE TO CODE encounters the opening delimiter it writes the subsequent
  179.    characters to the Code file until it reaches the closing delimiter.  The
  180.    code is considered complete after the closing delimiter. The program may
  181.    optionally place a marker (, ~, *, etc.) in the Uncoded file while
  182.    continuing to write the next characters, all this time searching for the
  183.    next opening delimiter.
  184.  
  185.    What It Can't Do
  186.    ________________
  187.  
  188. ** Once the markers are placed in the code file they cannot be erased or
  189.    reordered.  The markers indicate the exact location where the code
  190.    is to be returned.  The codes are replaced in sequential order.  Codes may
  191.    be freely add or delete copy while editing.  However, please be
  192.    certain not to move a code out of sequence or delete it.
  193.  
  194. ** WordPerfect, WordStart and other word processors that use proprietary
  195.    file formats must be converted to ASCII before using them with CODE TO
  196.    CODE.  See the word processor manual for ASCII file conversion.
  197.  
  198. ** Penta files can be coded without a closing delimiter.  CODE TO CODE can
  199.    be configured in the setup menu to treat a space or CR/LF (carriage
  200.    return/linefeed) as a closing delimiter.  This will work properly for
  201.    most codes.  However, codes such as [epNow will not be handled properly.
  202.    If there is enough user response, subsequent versions of CODE TO CODE
  203.    will handle this situation.  See the Penta section of this document for
  204.    more details.
  205.  
  206.    Installation
  207.    ____________
  208.  
  209.    The self-extracting archive file will unbundle the following files:
  210.  
  211.                 CTC.EXE  This is the main program.  It operates as a shell
  212.                          for the other "EXE" programs.  Although each of
  213.                          of the programs can be operated independently from
  214.                          the command line, initial use should be limited
  215.                          to CTC.EXE -- the shell program.
  216.  
  217.              DECODE.EXE  As its name implies, this program locates and
  218.                          removes the codes and creates the Uncoded and
  219.                          Code files.
  220.  
  221.              RECODE.EXE  This Program reassembles the Code file with the
  222.                          Uncoded file resulting in a new Encoded file.
  223.  
  224.                FILE.EXE  This program splits and rejoins files.  Use the
  225.                          /S switch to split and /J to join the files.
  226.  
  227.                                       Page 3
  228.  
  229.                 CTC.DTA  This is a very small file that tells CODE TO CODE
  230.                          how to configure CTC with your system.
  231.  
  232.                 CTC.DOC  This is the file that contains this documentation.
  233.  
  234.               QUADS.EXE  For certain typesetting systems it is necessary to
  235.                          insert carriage returns after quad codes.  QUADS.EXE
  236.                          allows the insertion of carriage returns after user
  237.                          specified quad.codes <QL>, <QC>, <EP>, etc.
  238.  
  239.                MAKE.EXE  This program automatically builds (makes) translation
  240.                          tables for use for use by CHANGE.EXE.
  241.  
  242.              CHANGE.EXE  This program will automatically search the original
  243.                          codes in the code file and replace them with the
  244.                          specified replacements in a new code file.
  245.  
  246.    Hard Disk Installation
  247.  
  248.    Copy all of files above to a subdirectory of your choice.  The DOS file
  249.    COMMAND.COM must be in the PATH statement or located in the working sub-
  250.    directory.
  251.                 Example:
  252.                                MD\CODES
  253.                                CD\CODES
  254.                                COPY A:*.*
  255.                                CTC
  256.    Floppy Disk Installation
  257.  
  258.    Copy all of the files above to a working floppy disk.  Please copy the
  259.    file COMMAND.COM from the DOS disk to the CODE TO CODE subdirectory if
  260.    COMMAND.COM is not the PATH.
  261.  
  262.    Operation
  263.    _________
  264.  
  265.            To Start The Program
  266.  
  267.    At the DOS prompt type CTC followed by ENTER.  If you have a monochrome
  268.    or LCD monitor type CTC /M followed by ENTER.  Please note that there is
  269.    a space before the /M.  For unregistered versions of CODE TO CODE  a
  270.    shareware screen will appear for 3 seconds.  Registered versions of
  271.    the program will start immediately.
  272.  
  273.    Notice that the main screen appears to be split horizontally in two
  274.    parts. The top half of the screen refers to decode, split and make
  275.    functions while the bottom half refers to the recode, join and change
  276.    functions.
  277.  
  278.            To Decode A File
  279.  
  280.    The cursor flashes at the first question [D]ecode or [R]ecode the file?
  281.    Selecting 'D' will display the Setup Menu to insure the system is
  282.    configured correctly for the type of file to be converted.  Most
  283.    errors are the result of improper values in the Setup Menu.
  284.  
  285.  
  286.                                       Page 4
  287.  
  288.    After the setup menu the top, or decode, portion of the screen becomes
  289.    highlighted while the cursor flashes on the question,  "What is the name
  290.    of the Encoded file?"  Answer this question with the drive, path and
  291.    file name of the file that is to be decoded.
  292.  
  293.                                     Example:
  294.         What is the name of the Encoded file?  d:\xywrite\ventura.doc
  295.  
  296.    Type the answer followed by ENTER.  Your answer will become capitalized
  297.    indicating the answer is complete.  The cursor will then move to the next
  298.    question, "What is the name of the Code file?"  Answer this question with
  299.    the drive, path, and file name of the file to hold the codes.  This file
  300.    will contain only the codes that have been extracted from the Encoded
  301.    file.
  302.  
  303.                                      Example:
  304.      What is the name of the Code file?  d:\xywrite\ventura.cds
  305.  
  306.    Type the answer followed by ENTER.  Your answer will become capitalized
  307.    indicating the answer is complete.  The cursor will then move to the
  308.    third question, "What is the name of the Uncoded file?"  Again, answer
  309.    this question with the drive, path and file name of the file to hold
  310.    the decoded text.  This file will contain the text without the codes.
  311.    Markers will have been placed in the positions previously occupied by
  312.    codes if the program is configured to do so.
  313.  
  314.                                      Example:
  315.       What is the name of the Uncoded file?  d:\xywrite\ventura.ctc
  316.  
  317.    IMPORTANT NOTE:  If the name for the Code file is omitted, the file is
  318.    stripped of the codes.  No markers are placed in the Uncoded file.
  319.    To strip a file of codes simply omit the name of the code file.
  320.  
  321.    Finally the cursor flashes at the question:
  322.  
  323.           What delimits the code? 1) <>  2) {}  3) []  4) «»  5) other ▒
  324.  
  325.  
  326.    Answer this question with the number that corresponds to the delimiters
  327.    used by the file to be converted.  Selecting '5' other will allow
  328.    specification of custom delimiters.  Type the number followed by ENTER.
  329.    CODE TO CODE will now process the file.
  330.  
  331.    Ventura Publisher
  332.    _________________
  333.  
  334.    Ventura Publisher files can originate from a variety of word processors.
  335.    Unfortunately, some of these programs create files (WordPerfect, WordStar,
  336.    etc.) that can only be read in their respective program.  However, to
  337.    circumvent this problem, use the FILE TYPE/RENAME option in the EDIT pull
  338.    down menu to convert the file to ASCII.  When the chapter is saved, the
  339.    file will be saved in an ASCII format suitable for CODE TO CODE.
  340.  
  341.  
  342.                                       Page 5
  343.  
  344.    Ventura Publisher files contain two coding schemes.  Most of the command
  345.    codes are delimited with the less than < and greater than > characters.
  346.    Within these delimiters codes will occur that relate to point size,
  347.    typeface, alignment, etc.  One of the most appealing features of Ventura
  348.    Publisher is the ability to create and use tags to format text.  The
  349.    delimiters used by Ventura tags are the at sign (@) and space(equal sign)
  350.    space.
  351.    A typical Ventura tag would appear as follows:
  352.  
  353.                     @MAINHEAD = 
  354.                     @SUBHEAD = 
  355.                     @BULLET = 
  356.  
  357.    To instruct CODE TO CODE to process a Ventura Publisher file, press 'D'
  358.    for decode.  When the setup menu appears,"Space or CR/LF for delimiter?"
  359.    should be set to 'N'.  The precedence character should be the at @ sign.
  360.    Select a marker character that is compatible with your word processor.
  361.    and not likely to occur in the text.
  362.  
  363.    CODE TO CODE is instructed that every time @ is selected as a delimiter
  364.    that a Ventura Publisher file is to be processed.  Answer 'Y' to the
  365.    Save these changes?.
  366.  
  367.    From the main screen, answer the three file questions appropriately.
  368.    What delimits the code will be option  1 <>.  CODE TO CODE will process
  369.    the file removing the tags as well as the delimited codes.  The new file
  370.    is now ready to be edited or spell checked in your word processor.
  371.  
  372.    XyWrite
  373.    _______
  374.  
  375.    All versions of XyWrite use the decimal 174 and 175 (French quotes)
  376.    characters as delimiters.  To process a XyWrite file, press 'D' for
  377.    decode.  When the Setup Menu appears, answer 'N' to "Space or CR/LF for
  378.    delimiter?".  Answer 'N' to precedence code.  Select a marker character
  379.    that is compatible with your word processor.  Answer 'Y' to "Save these
  380.    changes?".  Answer the next three file questions appropriately. "What
  381.    delimits the code?" will be option 4.«»
  382.  
  383.    CODE TO CODE will process the file.
  384.  
  385.    Penta
  386.    _____
  387.  
  388.    To instruct CODE TO CODE to process a Penta file press 'D' for decode.
  389.    When the Setup Menu appears, answer 'Y' to "Space or CR/LF for delimiter?"
  390.    Answer (;) semicolon for the precedence character.  These are the Penta
  391.    autosorts (semicolon followed by a 2-letter mnemonic) CODE TO CODE is
  392.    instructed that every time (;) is selected as a precedence character,
  393.    the  next two characters will determine a pi character to be called from
  394.    the pi font.  Select a marker character that is compatible with your
  395.    word processor.  Answer 'Y' to "Save these changes?".
  396.  
  397.    Answer the three file questions appropriately. "What delimits the
  398.    code"?  will be option 3 []. CODE TO CODE will process the file removing
  399.    the autosorts as well as the delimited codes.  The new file is now ready
  400.    to be edited  with your word processor.
  401.  
  402.                                       Page 6
  403.  
  404.    Magna
  405.    _____
  406.  
  407.    To instruct CODE TO CODE to process a Magna file, press 'D' for decode.
  408.    When the Setup Menu appears, answer 'N' to "Space or CR/LF for delimiter?"
  409.    The precedence character should be the dollar sign ($).  These are the
  410.    Magna dollar sign pi codes (dollar sign ($) followed by a 2-letter
  411.    mnemonic).
  412.  
  413.    CODE TO CODE is instructed that every time $ is selected as a precedence
  414.    character, that the next two non-numeric characters will determine a pi
  415.    character to be called from the pi font. Answer 'Y' to the Save to Disk
  416.    question.
  417.  
  418.    Answer the three file questions appropriately.  What delimits the code
  419.    will be option 1 <>. CODE TO CODE will process the file removing the
  420.    dollar sign pi characters as well as the delimited codes.  The new file
  421.    is now ready to be edited with your word processor.
  422.  
  423.    RECODE
  424.    ______
  425.  
  426.    The recode function is identical for all coding formats.  From the main
  427.    menu type 'R' for recode.  The cursor moves to the bottom portion of the
  428.    screen resting on, "What is the name of the new file?". Answer this
  429.    question with the drive, path and file name of the file that is to be
  430.    decoded.
  431.  
  432.                                       Example:
  433.          What is the name of the new file?  d:\xywrite\ventura.ctc
  434.  
  435.    Type the answer followed by ENTER.  Your answer will become capitalized
  436.    indicating the answer is complete.  The cursor will move to the next
  437.    question, "What is the name of the Code file?" Answer this question with
  438.    the drive, path, and file name of the file to hold the codes.  This file
  439.    will contain only the codes that have been extracted from the original
  440.    file.
  441.  
  442.                                        Example:
  443.          What is the name of the code file?  d:\xywrite\ventura.cds
  444.  
  445.    Type the answer followed by ENTER.  Your answer will become capitalized
  446.    indicating that the answer is complete.  The cursor will move to the
  447.    third question.  "What is the name of the Coded file?"  Again, answer
  448.    this question with the drive, path and file name of the file to hold the
  449.    decoded text. It is advisable to make this name different from the
  450.    original coded file so that the original is not overwritten.  CODE TO
  451.    CODE will, however, beep and display a warning message if you attempt to
  452.    overwrite the original file.  This file contains the text without the
  453.    codes.
  454.  
  455.  
  456.                                        Example:
  457.         What is the name of the new file?  d:\xywrite\ventura1.doc
  458.  
  459.                                       Page 7
  460.  
  461.    SPLIT
  462.    _____
  463.  
  464.    The split function allows the user to split large unmanageable text files
  465.    into smaller files.  The original file can be any length however, the
  466.    split files are limited to 64K (64000 characters). Just like Decode and
  467.    Recode above, the split files may be edited and then rejoined to make one
  468.    large file again.
  469.  
  470.    From the main menu type 'S' for split.  The cursor moves into the top
  471.    portion of the screen and rests on the question, "File name of file to be
  472.    split?".  Answer the question with the drive, path and file name of the
  473.    file that needs to be split.  Type the answer followed by ENTER. Your
  474.    answer becomes capitalized indicating the answer is complete.  The cursor
  475.    will move to the next question, "File name for the split files? (no ext)."
  476.    Answer this question with the drive, path and file name for the split
  477.    files.  CODE TO CODE will automatically add and increment the extension
  478.    number starting with 1. Type the answer followed by ENTER.  Your answer
  479.    again becomes capitalized indicating completion. The cursor moves to the
  480.    question, "String to break the file after?"  Answer this question with
  481.    the string of characters which determines where the file is to be closed
  482.    and the next one opened.  Note:  If you are using the command line option
  483.    this string must be surrounded with quotes. example "[ep]."
  484.  
  485.    Typically, typesetter files use the end of paragraph code (<EP> [ep]) while
  486.    Ventura Publisher uses a carriage return.  If this question is left blank,
  487.    CODE TO CODE will break the file at the first carriage return encountered
  488.    after reading the number of characters you indicated as the size of the
  489.    split files. Type the answer followed by ENTER.  The answer WILL NOT
  490.    become capitalized because this string needs to be cap sensitive.  The last
  491.    question is "No. of characters for the split?".  Enter any number up to
  492.    64000 (no commas).  CODE TO CODE reads this number of characters, stops,
  493.    then continues to read more characters until the break string is
  494.    encountered.  Then the program closes the current file and opens the next.
  495.  
  496.    JOIN
  497.    ____
  498.  
  499.    The join function reassembles the split files into a single file.  Select
  500.    'J' for join from the main menu.  The lower portion of the screen becomes
  501.    highlighted and the cursor rests on the question, "File name to hold
  502.    split files?".  Answer this question with the drive, path and name of the
  503.    one large file that will be made up from the smaller split files.  Type the
  504.    answer followed by ENTER.  Your answer becomes capitalized indicating the
  505.    answer is complete.  The cursor will move to the next question, "File
  506.    name of the split files?".  Answer this question with the file name
  507.    (without the extension) of the files that were previously created by the
  508.    Split option.  Answer the question followed by ENTER.  Your answer again is
  509.    capitalized indicating completion.  The cursor moves to the final question,
  510.    "How many split files?".  Answer the question with the number of files that
  511.    the split option previously created.
  512.  
  513.                                       Page 8
  514.    MAKE
  515.    ____
  516.  
  517.    The MAKE function automatically creates a translation tables for use by the
  518.    CHANGE function.  Select 'M' from the main menu.  The upper portion of the
  519.    screen becomes highlighted and the cursor rests on the question," File name
  520.    of the Code File?  Answer this question with the file named used previously
  521.    with the Decode option.  This is the name of the file that contains codes
  522.    only.  Answer the question followed by ENTER.  The cursor moves to the
  523.    final question, "File name for the code table file? (.tbl)".  Answer the
  524.    question with the name of a file to contain the SEARCH/REPLACE couplets.
  525.    The structure of this file is nothing more than the search code on line one
  526.    followed by a carriage return and the replacement code on the next line
  527.    followed by a carriage return.  Answer the question followed by ENTER.  The
  528.    program will search the code file looking for distinct codes.  A banner
  529.    will appear at the bottom of the screen indicating the number of distinct
  530.    codes found.  After pressing a key, the first code will be displayed
  531.    with a prompt for a replacement code.  If you wish to replace the code
  532.    type the replacement followed by ENTER.  If you wish to delete the code
  533.    press ENTER alone.  Go through all of the codes typing replacements for
  534.    the ones you know are appropriate and ENTER by itself for the codes that
  535.    are not compatible.  The MAKE function can handle codes up to 256
  536.    characters in length, however, only the first 25 characters are considered
  537.    significant.  Therefore, <this is a test code from would be identical to 
  538.    <this is a test code from a Ventura file>. If the code file contains codes
  539.    longer than 25 characters and they may be worded similarly, use the manual
  540.    table creation methods discussed below.
  541.  
  542. ** Translation tables may be created manually using  DOS, or any editor or
  543.    word processor capable of storing a file in an ASCII format. Type the code
  544.    as it appeared in the file on the first line followed by a carriage return.
  545.    Then type its replacement on the second line followed by a carriage return.
  546.    Using this method, it is possible to translate all of the codes from one
  547.    system to the corresponding codes of another system.
  548.        
  549.                                       Example
  550.                 MagnaType to Ventura Publisher using an ASCII editor
  551.       
  552.                  [UG1]
  553.                  @HEADLINE = 
  554.                  [UG2]
  555.                  @SUBHEAD = 
  556.                  $BU
  557.                  <195>
  558.  
  559.                                       Example
  560.                 MagnaType to Ventura Publisher using DOS
  561.              
  562.                  At the DOS prompt type:
  563.                  copy con mytrans.tbl   --copy console and the filename--
  564.                  [UG1]
  565.                  @HEADLINE = 
  566.                  [UG2]
  567.                  @SUBHEAD = 
  568.                  $BU
  569.                  <195>
  570.                  ^z                     --Control Z
  571.                  ENTER
  572.  
  573.                                       Page 9
  574.  
  575.    CHANGE
  576.    ______
  577.  
  578.    The change function translates the codes by processing the information in
  579.    the code table file (.tbl) and the code file. Select 'C' from the Main 
  580.    Menu.  The lower portion of the screen becomes highlighted and the cursor
  581.    rests on the question, "File name of the table file (.tbl).  Answer the
  582.    question with the name of the table file you created using the Make
  583.    function.  Press ENTER then the cursor moves to the second question, "What
  584.    is the name of the old code file?"  Answer the question with the name of
  585.    the file you used when you used the Decode function.  Press ENTER and the
  586.    cursor moves to the final question, "File name of the new code file?". 
  587.    Answer this question with the name of a file to hold the new translated
  588.    codes.  Press ENTER and the program will process the codes.
  589.  
  590.    To place the new codes back in the file use the Recode function with the 
  591.    uncoded file, this new code file, and the name of the new finished file.
  592.  
  593.    QUADS
  594.    _____
  595.  
  596.    Many professional typesetting systems automatically filter out carriage
  597.    returns and multiple spaces.  In these cases running DECODE on this type
  598.    of file will result in a "decoded" file that is ONE HUGE PARAGRAPH.  To
  599.    prevent this, run the QUADS.EXE program before running DECODE.  QUADS will
  600.    allow you to specify two quad codes ([QL],[EP], etc.) that will be
  601.    converted to a carriage return/line space.
  602.  
  603.    Since this problem only affects some users, QUADS.EXE only operates from
  604.    the command line.  The syntax for operating QUADS.EXE is:
  605.  
  606.            QUAD [origfile] [newfile] ["1st quad code"] ["2nd quad code"]
  607.  
  608.         Example:  Quad original.fil fixed.fil "<EP>" "<QL>"
  609.  
  610.    Note:  The quad codes must be surrounded by quotes.  Some command
  611.    delimiters are interpreted by DOS as redirection operators unless they are
  612.    set off by quotes.  DOS will return a file not found error if the quad
  613.    code appears without the quotes.
  614.  
  615.    Main Screen Options
  616.    ___________________
  617.  
  618.    F1  ON-LINE HELP   On-line help is available in CODE TO CODE by pressing
  619.                       the F1 key almost anywhere in the program.  The program
  620.                       documentation can be read while operating the program
  621.                       by using the F4 VIEW option and enter CTC.DOC as the 
  622.                       file to view.
  623.  
  624.    F2  SETUP          Configuration information for the program.
  625.  
  626.    F3  DOS            Pressing F3 anywhere in the program will suspend
  627.                       CODE TO CODE and return to the DOS prompt.  CODE TO
  628.                       CODE is still in memory and can be recalled by typing
  629.                       EXIT at the DOS prompt.  You will return to where you
  630.                       were when you left the program.  This feature is handy
  631.  
  632.                                       Page 10
  633.  
  634.                       for formatting diskettes or viewing a directory. Note:
  635.                       CODE TO CODE must be able to find COMMAND.COM in the
  636.                       working sub directory or in the PATH statement for this
  637.                       option to work correctly.
  638.  
  639.    F4  VIEW           Pressing F4 will prompt the user for the file name to
  640.                       view.  Answer with the file name then press [ENTER].
  641.                       The file will be displayed one page at a time. Use PGDN
  642.                       to move down a page and use PGUP to backup a page at
  643.                       a time.  Use HOME to return to the beginning of the
  644.                       file.  CODE TO CODE will default to display tab
  645.                       characters as  and carriage returns as <-.  F3
  646.                       will toggle these characters off and on. ESC returns
  647.                       to the CODE TO CODE main menu.
  648.  
  649.    F5  CALC           F5 offers a full function calculator.  The calculator
  650.                       features standard math operations such as ADDITION,
  651.                       SUBTRACTION, MULTIPLICATION, DIVISION and GRAPHIC
  652.                       conversions of Picas & Points to inches and vice versa.
  653.  
  654.                       At the cursor type the first number of your calculation
  655.                       followed by ENTER.  Next type the math operator
  656.                       (* multiply, / divide, + add, - subtract).  The cursor
  657.                       will jump to the third shaded box. Type the last number
  658.                       of your calculation followed by ENTER. The answer is
  659.                       displayed to the right.  Press ENTER to start another
  660.                       calculation or ESC to return to the main menu.
  661.  
  662.                             example:     2▒▒▒▒▒▒▒ + 2▒▒▒▒▒▒▒▒ = 4.00
  663.  
  664.                       To convert from picas and point to inches, enter the
  665.                       number to be converted followed by ENTER, then type P.
  666.                       The conversion is shown to the right. To convert from
  667.                       inches to picas and points, enter the number to be
  668.                       converted followed by ENTER.  Next type I followed by
  669.                       ENTER.  The conversion is shown to the right.
  670.  
  671.                       example:       21,06▒▒▒ Picas & Points -> 3.57 Inches 
  672.  
  673.                       example:       3.57▒▒▒▒ Inches -> 21 picas 6 points
  674.  
  675.                      *please note: inches are decimal. For example, one and
  676.                       one half inches is notated as 1.50
  677.                       
  678.                       Picas and points are notated with a coma.  For example
  679.                       one and one half Picas is notated as 1,06.  Remember
  680.                       Picas and Points are measuring systems with a base of
  681.                       12 not 10 as in decimal.
  682.  
  683.    F10  EXIT          Leave the program and return to DOS.
  684.  
  685.  
  686.                                       Page 11
  687.  
  688.    Advanced Information
  689.    Command Line Options
  690.    ____________________
  691.  
  692.    The programs DECODE.EXE, RECODE.EXE, and FILE.EXE are stand alone
  693.    programs that can operate independently from the command line.  Since
  694.    using these programs from the command line circumvents the CTC.EXE program,
  695.    certain information has to be passed to each program on the command line.
  696.    The command line parameters are:
  697.  
  698.    NOTE:  When using the command line option, the delimiters must be
  699.    enclosed by quotation marks,("<>" "[]") and you are responsible for
  700.    checking the contents of the CTC.DTA file. In other words make sure that
  701.    the three Set Up questions are appropriate for the files you are about
  702.    to convert.  RECODE, DECODE and FILE use the CTC.DTA file.
  703.  
  704.    DECODE [delimit] [Encoded file] [Uncoded file] [code file]
  705.    ───┬──  ───┬────  ───────┬────   ────┬───────   ┬────────
  706.       │       │             │           │          │
  707.       └───────┼─────────────┼─────> Program name   │
  708.               │             │           │          │
  709.               └─────────────┼───────────┼> Delimiters: These must
  710.                             │           │  be placed in quotation
  711.                             │           │  marks example: "<>"
  712.                             │           │          │
  713.                             └───────────┼─────> Drive, path and file
  714.                                         │       name of the file to be
  715.                                         │       decoded
  716.                                         │          │
  717.                                         └──────────┼─> Drive, path and file
  718.                                                    │   name of the new file
  719.                                                    │   to hold the decoded
  720.                                                    │   text
  721.                                                    │
  722.                                                    └─> Drive, path and file
  723.                                                        name of the file to
  724.                                                        hold the codes.
  725.  
  726.  
  727.    RECODE [text file] [code file] [output file]
  728.    ───┬──  ─────┬───   ────┬────   ────┬──────
  729.       │         │          │           │
  730.       └─────────┼──────────┼──────> Program name
  731.                 │          │           │
  732.                 └──────────┼───────────┼─> Drive path and file
  733.                            │           │   name of the file that
  734.                            │           │   contains the codes
  735.                            │           │
  736.                            └───────────┼─────> Drive, path and file
  737.                                        │       name of the file in
  738.                                        │       which to write the
  739.                                        │       codes.
  740.                                        │
  741.                                        └────────> Drive, path and file
  742.                                                   name of the file to put
  743.                                                   the reassembled text and
  744.                                                   codes in.
  745.  
  746.  
  747.                                   Page 12
  748.  
  749.    FILE /S [original] [split file] [no. characters] ["break string"]
  750.    ──┬─ ─┬  ────┬───   ────┬─────   ───┬──────────   ───┬────────
  751.      │   │      │          │           │                │
  752.      └───┼──────┼──────────┼────>  Program name         │
  753.          │      │          │           │                │
  754.          │      └──────────┼────────> Drive path and file
  755.          │                 │          name of the large file
  756.        Split               │          to be split.      │
  757.        Switch              │           │                │
  758.                            └───────────┼> Drive, path and file
  759.                                        │  name of the file to
  760.                                        │  write the split files to.
  761.                                        │                │
  762.                                        │                │
  763.                                        └──> Number of characters that each
  764.                                             split file should contain.
  765.                                                         │
  766.                                                         
  767.                                                 String to break each
  768.                                                 split file on. This string
  769.                                                 must be surrounded with quotes
  770.     
  771.  
  772.    FILE /J [text file] [split files] [no. of split files]
  773.    ─┬─  ┬─  ────┬────   ───┬───────   ─┬────────────────
  774.     │   │       │          │           │
  775.     └───┼───────┼──────────┼────────> Program name
  776.         │       │          │           │
  777.         │       └──────────┼───────────┼─>  Drive path and file
  778.         │                  │           │    name of the file that
  779.         │                  │           │    will contain the split files
  780.       Join                 │           │
  781.       Switch               └───────────┼─────> Drive, path and file
  782.                                        │       name of the split files
  783.                                        │
  784.                                        └─────────> Number of split files
  785.                                                    that are to be combined
  786.  
  787.  
  788.  
  789.    MAKE [code file] [table file (.tbl)
  790.    ──┬─ ─────┬───   ────┬────   ────┬──────
  791.      │       │          │           │
  792.      └───────┼──────────┼──────> Program name
  793.              │          │           │
  794.              └──────────┼───────────┼─> Drive path and file
  795.                         │           │   name of the file that
  796.                         │           │   contains the codes
  797.                         │           │
  798.                         └───────────┴─────> Drive, path and file
  799.                                             name of the file to contain
  800.                                             the translation couplets.
  801.                                             (SEARCH/REPLACE)
  802.  
  803.  
  804.                                        Page 13
  805.  
  806.    CHANGE  [.tbl file] [code file] [new code file]
  807.    ───┬──  ─────┬───   ────┬────   ────┬──────
  808.       │         │          │           │
  809.       └─────────┼──────────┼──────> Program name
  810.                 │          │           │
  811.                 └──────────┼───────────┼─> Drive path and file
  812.                            │           │   name of the file that
  813.                            │           │   contains the codes table
  814.                            │           │
  815.                            └───────────┼─────> Drive, path and file
  816.                                        │       name of the file where
  817.                                        │       the codes were stored using
  818.                                        │       DECODE.
  819.                                        │
  820.                                        └────────> Drive, path and file
  821.                                                   name of the file to put
  822.                                                   the translated codes in.
  823.  
  824.  
  825.    QUADS [origfile] [newfile] [\"1st quad code\"] [\"2nd quad code\"]
  826.    ____ _________  _________  _________________   _________________
  827.     │       │         │            │                  │
  828.     └ Program name   │            │                  │
  829.             │         │            │                  │
  830.             └ Name of the file to process            │
  831.                       │            │                  │
  832.                       └ Name of the new files        │
  833.                                    │                  │
  834.                                    │                  │
  835.                                    └  1st quad code in quotes
  836.                                         ex. \"<EP>\"  │
  837.                                                       │
  838.                                                       │
  839.                                                       └ 2nd quad code in
  840.                                                          quotes.
  841.  
  842.